home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / doors_1 / cook_200.zip / COOKIE.DOC < prev    next >
Text File  |  1992-07-01  |  9KB  |  190 lines
  1. =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
  2.         COOKIE.EXE v2.00 - Fortune Cookie program for ALL BBS systems 
  3. Written by Earl Ruby @ KnowledgeMatters, 510/935-4878, Fidonet Node 1:161/201
  4.      The latest version of this program is available via FREQ as COOKIE
  5. =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
  6.  
  7.  
  8.                          <<<*>>> HISTORY <<<*>>>
  9.  
  10. I used to run a BBS system which used a little-known software package called
  11. The DMG BBS System. The DMG System had a number of interesting features, 
  12. including built-in games, a user-generated Bulletin section, and a file 
  13. system that let you cross-reference files across multiple file sections. The 
  14. DMG System also had a built-in fortune cookie program that would spew forth a
  15. witty little saying or a quote when you logged off the system.
  16.  
  17. The original cookie file used by the DMG System was about 200K in size. I 
  18. started adding to the file, typing in funny quotes that I'd heard and merging
  19. text files containing quotes that I would run across. Eventually the file 
  20. grew to over 450K in size.
  21.  
  22. In January 1991 I switched software packages and started using Remote Access 
  23. BBS software. Remote Access had many features that the DMG System lacked -- 
  24. and it was STABLE. I didn't have to worry about having the system crash while
  25. I was gone on weekends, something which happened quite often with the DMG.
  26.  
  27. I wrote this program because there was no COOKIE program built into Remote 
  28. Access. When I wrote the COOKIE program I wanted to make sure that it would 
  29. run under ANY BBS system, because it was possible that I would switch systems
  30. again. I've stuck with Remote Access -- I love it -- and the COOKIE program 
  31. is still running strong and the cookie file keeps growing in size. 
  32.  
  33.  
  34.                        <<<*>>> VERSION 2.00 <<<*>>>
  35.  
  36. The changes in version 2.00 are as follows:
  37.  
  38. * A new random-number algorithm has been implemented to make the cookies even
  39.   more random. However, bigger cookies tend to be displayed more often 
  40.   because there is a greater chance of "hitting" a big cookie within the 
  41.   cookie text file.
  42.  
  43. * More cookies have been added! There are now more than 1.1 megabytes of 
  44.   cookies included with the program. I especially want to thank Joe Russack 
  45.   of UCSC for sending me an 800K file of cookies that he had. If anyone else 
  46.   out there has a file of cookies that they'd like to see included, please 
  47.   send them in!
  48.  
  49. * With all of the new cookies, there were bound to be duplicates. I wrote a 
  50.   program to analyze the file and remove duplicates, as well as to sort the 
  51.   cookies in alphbetical order. Over 2000 duplicates were removed from the 
  52.   file.
  53.  
  54. * I received netmail from a couple of people regarding spelling errors and 
  55.   mis-attributed quotes. The ones that were brought to my attention have been
  56.   corrected. I have not yet run the file through a spell-checker because 
  57.   proper nouns, computer jargon, and nonsense-words make up quite a bit of 
  58.   the file, and it's going to take me hours to go through the entire thing. I
  59.   hope to have the everything spell-checked by the *next* release.
  60.  
  61. * I broke the cookie file into separate files by "type of cookie." The file 
  62.   names are:
  63.  
  64.   COOKIE.CKS      Miscellaneous cookies
  65.   ONELINER.CKS    One-liners, quick quotes
  66.   BARRY.CKS       Quotes from Dave Barry
  67.   STARTREK.CKS    Quotes from Star Trek
  68.   ZIPPY.CKS       Quotes from Zippy the Pinhead
  69.  
  70. * There is a new file called MERGE.BAT. This program will take all of the 
  71.   separate cookie files and merge them into one file called COOKIES.TXT. You 
  72.   can edit MERGE.BAT so that it only includes the cookie files that you want 
  73.   to display.
  74.  
  75.  
  76.                        <<<*>>> REGISTRATION <<<*>>>
  77.  
  78. The COOKIE program is Shareware. If you like it, send me a check for $10 or
  79. so payable to "KnowledgeMatters" and I will feel very flattered. (As one of
  80. the quotes says: "Money is the sincerest form of flattery.") My mailing
  81. address is:
  82.  
  83.    KnowledgeMatters
  84.    Attn: Earl Ruby
  85.    P.O. Box 5485
  86.    Walnut Creek, CA  94596
  87.  
  88. If you register and you give me a Fidonet address where you can be reached, 
  89. I will send you NetMail whenever a new version of the cookie file comes out.
  90.  
  91. I can be reached on The KnowledgeMatters BBS @ 510/935-4878, Fidonet node 
  92. 1:161/201. The latest version of COOKIE can always be File-Requested (FREQ) 
  93. using the magic name "COOKIE" at HST DS speeds.
  94.  
  95.  
  96.                     <<<*>>> USING THE PROGRAM <<<*>>>
  97.  
  98. To use the program, stick the following line of code into your batch file 
  99. immediately before the batch file starts up the BBS system:
  100.  
  101. COOKIE cookie_file output_file
  102.  
  103. Where:
  104.   cookie file = path and name of the text file with cookies
  105.   output file = path and name of the file for a single cookie
  106.  
  107. Since I'm using Remote Access, and Remote Access displays a file called 
  108. GOODBYE.ANS (ANSI) or GOODBYE.ASC (ASCII) when the user logs off the system, 
  109. I could use the following line of code in my batch file:
  110.  
  111.   COOKIE COOKIES.TXT C:\RA\TEXT\GOODBYE.ASC
  112.  
  113. This would create an ASCII file that the user would see when they logged off 
  114. the system. 
  115.  
  116. However, let's say that I want to generate ANSI and ASCII versions of the 
  117. quote, and I want to add a header to the message stating something like: 
  118. "Thanks for calling! The cookie monster says:" before the cookie is 
  119. displayed. To accomplish this I create two files, one called GB.ASC and one 
  120. called GB.ANS. These have a clear-screen character and the header message in 
  121. them. The .ANS file also contains color-changing information. To use these 
  122. headers, I add the following to my BBS batch file:
  123.  
  124.   COOKIE COOKIES.TXT TEMP.TXT
  125.   COPY GB.ANS+TEMP.TXT C:\RA\TEXT\GOODBYE.ANS
  126.   COPY GB.ASC+TEMP.TXT C:\RA\TEXT\GOODBYE.ASC
  127.   DEL TEMP.TXT
  128.   (then call the BBS program)
  129.  
  130. This works just fine for creating ANSI and ASCII copies of the file.
  131.  
  132.  
  133. The cookie file is broken into sections. If you do not have room on your 
  134. hard drive to keep ALL of the cookies on-line, you can pick a section or  two
  135. and just keep those sections on-line. The sections are stored in  separate
  136. files. The file names are:
  137.  
  138.   COOKIE.CKS      Miscellaneous cookies
  139.   ONELINER.CKS    One-liners, quick quotes
  140.   BARRY.CKS       Quotes from Dave Barry
  141.   STARTREK.CKS    Quotes from Star Trek
  142.   ZIPPY.CKS       Quotes from Zippy the Pinhead
  143.  
  144. There is also a file called MERGE.BAT. This program will take all of the 
  145. separate cookie files and merge them into one file called COOKIES.TXT. You 
  146. can edit MERGE.BAT so that it only includes the cookie files that you want 
  147. to display.
  148.  
  149. The merge file consists of the command:
  150.  
  151.   COPY COOKIE.CKS+BARRY.CKS+ONELINER.CKS+STARTREK.CKS+ZIPPY.CKS COOKIES.TXT
  152.  
  153. After reading Dave Barry quotes for the past 5 years I was getting pretty 
  154. tired of them, so I used the command:
  155.  
  156.   COPY COOKIE.CKS+ONELINER.CKS+STARTREK.CKS+ZIPPY.CKS COOKIES.TXT
  157.  
  158. That merged all of the separate cookie files, except for the Dave Barry 
  159. quotes, into one file called COOKIES.TXT.
  160.  
  161.  
  162.                        <<<*>>> THE COOKIE FILE <<<*>>>
  163.  
  164. The COOKIES.TXT file is a collection of quotes, sayings, pearls of wisdom, 
  165. jokes, and funny news items. Each cookie is separated by a "}" at the 
  166. beginning of the cookie. There is no minimum or maximum cookie length. You 
  167. can have a cookie file of nothing but one-liners, or a cookie file consisting
  168. of nothing but quotes from Alice in Wonderland.
  169.  
  170. I know of one Remote Access BBS using this program that has a file of 
  171. practical jokes and pranks (& the Temple of the Screaming Electron BBS, 
  172. 510-935-5845). If a user selects the [P]rank option from the BBS's menu, it 
  173. calls the COOKIE program, extracts a prank, and then displays the prank using
  174. a "display ASC/ANS file" menu option. Very amusing!
  175.  
  176. The COOKIES.TXT file is the product of several year's worth of collecting 
  177. quotes, sayings, and other related trivia. People are always sending me new 
  178. files of quotes to add to the file. If you have some quotes you'd like to see
  179. added, send them to me via NetMail or upload them to the KnowledgeMatters BBS
  180. and I'll put them in the next release.
  181.  
  182.  
  183.                                                                  Earl Ruby
  184.                                                       KnowledgeMatters BBS
  185.                                                    1:161/201, 510/935-4878
  186.                                                                   07/01/92
  187.  
  188. =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
  189.  
  190.